• Take control of your ftp server and get rid of ppl joining, logging on and leaving again.
• Making requesting files from DCC fileservers easier and faster and more automated
• Simplify the work with eggdrop bots on the partyline

As for some limitations in the supported servers this script makes use of "triggers" to get to know ppl who want to log in to your ftp. So it's not just posting an IP:port with login/pass in the channel.

This Script
• requires mIRC 6.0 (or higher) to work.
• does not support language packages for eggdrop bots !
• was not tested for use over multiple networks, so if you wan to use it's abilities while on more than one network it may/will fail. Don't even bother sending me bugreports when you're using it this way!

I do not make a new version/built for everything i changed but only for important changes. I simply work on this script everyday and try to improve it!

If Auto-Update doesn't work (progress bar doesn't advance for a long time or the script is still the same after update) you can get the script manually from my homepage. Unload the old script with the button in misc tab and keep the settings. Overwrite all files with the files from the archive you downloaded.
Then just load the script as you did the first time.

Whenever you encounter an error or have any questions or feature requests always include the following into your message:

• The text being displayed with
  //echo -a $sq.version
  into any mIRC window
• For Bugs include the exact circumstances when the error appears and include the errormessage itself. Also include any other loaded scripts.
• For feature requests try to give a very good and detailed description of it
• Your IRC network and your nickname there if you need help. Also tell me your timezone ;-)
  

For new modules for other FTPservers i need the server first to make a working script for it. So freeware FTPserver will be prefered as i do not want to spend money for servers i do not use. If you want a module for your server you should also bring up a solution for this problem.
For WarFTPd, I'm waiting for version 3 to come out.
After having a look at Serv-U it seemed pretty impossible to make it communicate with it.

• Access Rights including Home directory
• Miscellaneous as you like
• Links&Messages as you like

Welcome on my FTP
^accountomat
ftp://^login:^password@^ip:^port/
have fun

When you check back the triggermsg the next time you may see a <HEADER> line, just DON'T TOUCH it !

§ My FTP on /ctcp $me ^trigger § right now I'm serving for ^loggeddown users §

ADSL users should make use of the speedlimit option in the "FTP server" tab as it is the overall speed limit shared by all users, e.g.:
you have and adsl line with 512/128kBps this is 16kb/s upstream
so if your complete upstream of 16k would be used up your downloadspeed begins to be crapy, so select something like 12000bytes/s, this should not affect your download rate.
This speed is shared by all users:
one user on the ftp can use full 12k
two users then only can have 6k each, and so on.

Welcome on my FTP
^accountomat
ftp://^login:^password@^ip:^port/
have fun

When you check back the triggermsg the next time you may see a <HEADER> line, just DON'T TOUCH it !

§ My FTP on /ctcp $me ^trigger § right now I'm serving for ^loggeddown users §

• You want to request lots of files but only a few files are permited in the server queue.
• The server is very unstable and your requests get broken everytime you enqueue them again.
• You want a lot of files from many servers, but queueing would take too long

• It allows huge request lists from up to 8 servers to be requested at the same time.
• It resumes broken requests until all files are complete.
• If a server is unreachable it resumes requesting as soon as it enters the channel and probes the server if it is temporary shut down.

• Choose the channel #CHANNEL from the first drop down box
  
• Select NICK from the 2nd box (type his beginning letter "N" to find him faster)
  
• As you know NICK only allows 1 file in queue don't change it (use a value of 0 to autodetect)
  
• As you want all :ZIP files from NICK don't change this either
  NOTE: No wildcards are allowed, so .* will not select all files
  
• Click on the request list button and select the listing of files you you want from NICK
  Depending on how long the file is, this step may take a while, so don't panik!
  
• If everything is correct you can click on ADD TO LIST to add him to the request list
  
• Now click on START REQUESTING NOW and close the menu with ok, and watch what happens
  
  

Errormessages from the fileserver are redirected to the @SQ-Script! window, so check it, if you did not recieve a confirmation for your request. Most likely you hit the queue limit (the script will stop requesting more automatically).

• TAB 1 (Trigger/@find)

• Connection to FTP
  This is merely used as an indicator than as a switch, as it is enabled when the script could establish a connection to the server and disabled if this connection is lost. As long as this is set to OFF anyone using the FTP-info-trigger will only get the notice that the server is down.
  
  
• Trigger-Status:
  If this button is turned OFF it will prevent the script to react to trigger requests in the channel. Does only affect the FTP-info-trigger.
  
  Connect to FTP-server:
  If this is turned of the script will not attempt to establish a connection to the FTPserver. It will not terminate any existing connection and is turned off by default.
  
  
• Your FTP Trigger:
  This is a keyword needed to make the script display the trigger info to the person typing this keyword into the channel.
  
  Your List-trigger:
  This keyword is used to request your fileslist chosen for the @find option. It listenes to channels and queries.
  
  
• Choose a usertype:
  This combo box lets you choose 4 different states: OP/Voice/Regular/All
  It let's you create different FTP-infos for a different status in the channel. At least one "All" should always exist and the other selections may be used for extended access.
  
  
• Select a channel:
  Here you can select one of all channels you were resident at the moment you opened the menu. This way you can create different FTP infos for different chans or for some selected chans at all.
  To use the same FTP-info for multiple channels, create one for the first channel as described above and afterwards reopen the menu and select the appropiate usertype and channel and the FTP info will appear with a header in the top line.
  Copy the complete info text into you clipboard (including the header) and select another channel and past it in. Now click on APPLY and repeat pasting as often as you want (don't forget to apply before choosing another channel).
  
  <FTP-info>
  Here you can enter any text to be displayed if someone triggers your keyword chosen above. Variables can be used here. You should read about variables in Tab2 (Stats).
  DON'T REMOVE THE HEADERLINE ! It simply stores some setting and is not shown at any time.
  
  
• Chat Port
  As the Script establishes a DCC CHAT connection to the user of the trigger you can set the value for the portrange here. Either enter a single port or a portrange delimited by minus "-" or colon ",".
  Only modify these values if you are behind some router/firewall and have problems establishing the connections.
  
  
• Preview ?????? as sysmsg
  This button appears on multiple places in the menu. It uses the actual related text entered in the menu and posts it to the SQ-Script! window in mIRC with all variables replaced by their actual values. You should use this button often =)
  
  
• Listen for /ctcp <yournick>
  This makes the script not to listen in the channel for the FTP-info trigger but as a private CTCP command. So if your FTP-info keyword would be FTP someone who wants to access your server would need to type /ctcp <yournick> FTP to make the script react.
  Else someone would just need to enter FTP into a channel you have a trigger configured for. This was added for chans which do not allow triggers in the channel.
  
  
• <@find text>
  Here you can enter any text to be displayed if someone uses @find and the script finds anything matching the request. Variables can and should be used here.
  Read about variables in Tab2 (Stats) !
  
  
• @Find-Status
  If turned off the script will not react to @find requests.
  
  Your Files-list
  Lets you choose an external fileslist. I recomend using the inbuilt fileslist maker.
  
  
• Number of matches to be displayed
  If a search request by someone exceedes this number of matches he is told to request your fileslist using the keyword chosen above or to make a more specific request.
  
  
• Send matches as txt-file if exceedes limit
  If checked someone making a search request and having to many matches would not get notified to request you entire list but is send the complete list of matches via DCC.
  
  
• Listen for /ctcp <yournick>
  Same as above. Read about the @find server<->client for more useful information
  
  
• Make list
  This opens a new menu where you can setup the internal fileslist creator. In fact it only lists all filenames in the directories you specified recursively into a plain ASCII file called sq.fileslist.txt resident in the directory you unziped the script to. When putting something in front of a filename this may be a colorcode or whatever. It was added for some style freaks who loved colors.
  The file is automatically entered to the <Your Files-list> button.
  
  
• Connect to @find server
  This is especially added for channels which do not allow @find in the channel or any other automated triggers (so called "quiet" channels). Use it with "Listen for /ctcp <yournick>", at least on the HUB. First you should choose someone with a reliable internet connection and preferably a static IP (dyndns and thelike work as well). This person will be the server or HUB. So you just click on the button and enter his IP or named address (dyndns) and check the @SQ-script! window for the results after clicking on apply.
  Once the connection is established anyone who wants to make a search request can use /ctcp <nick-of-the-HUB> @find <whatever-he-is-looking-for> The hub will then distribute this request to everyone connected (TCP port 17000) including himself. In fact he is just connected to himself on localhost. This way no @find requests will be visible in the channel, but you should not forget to publish the HUBs nick somewhere (preferably topic).
  
  
• <The Squirrel>
  Clicking on it will add some extra visual abilities to your mIRC =)
  If you don't like them click again once. It may take a while until it's back to normal
  
  

• TAB 2 (Stats)
  

• Stats-trigger Status
  If turned OFF the script will not react on the keyword used to siplay the stats below
  
  
• Enter Stats-trigger
  This may be any keyword(s) you want the script to listen for to display the stats message below. It will only listen for the keyword in the query as a private message for flood reasons (10people using !stats as keyword listening in the channel......)
  
  
• Choose Variable
  This lets you browse through all available variables provided by the script and their usage. These can be used in the FTP-info, @find and many other places, too.
  It's recommended to read through, you can try them out below.
  
  
• Setup ^NewOnServer variable
  This lets you configure the contents of the ^NewOnServer variable. Read about it above
  
  
• <Stats text>
  Here you can enter any text you want to be messaged to the person activating your Stats-trigger using the keyword chosen above. You can also use this place to try out variables described above using the Preview button below.
  
  
• Enable Server- and PC-stat variables (only BPFTPserver) This enables the option to make the BPFTPserver (G6) to evaluate some of the variables described above. They should not be refreshed too frequently as the generate extra server load.
  
  

• TAB 3 (Misc)

• Load Script
  This let's you choose a script file you want to be loaded into mirc basically it's the same as //load -rs " $+ $sfile($mircdir) $+ "
  
  
• Unload SQ-script
  As you might think this unloads SQ-script from your mIRC and you are asked if you want to delete all settings, too. To update SQ-script you can use this button and keep the settings, so you simply overwrite the all files and load it as the first time. All settings will be taken over and new features will be disabled.
  Unloading will not remove the files.
  
  
• Reset all values to default
  This will restore the default settings of the script like the first time you loaded it. All changes you made will be lost as soon as you click OK. There is no UNDO !
  
  
• Other loaded scripts
  This list all other loaded script files. To unload a script you can select it in the list and then click on the UNLOAD SCRIPT button below.
  
  
• Set the security level of CTCP floodprotection.
  As on some IRCnets the ctcp can be a real threat to users (you can be flooded out of the net) I added this feature. The script tries to recognize flood attacks according to this level. In fact this is the time that must pass between the first ctcp and the third. So if you set the level 4 and you recieve 3 ctcps in less than 4 seconds the floodprotection is triggered. remeber that on some channels channel-ctcps are very common any you will notice the floodprotection beeing activated several times without any obvious reasons. To prevent this you can block these known CTCPs below or you can set the security level to a lower one.
  DCC sends are not counted this way but are also blocked when the floodprotection is activated for some reason.
  
  
• Minimize mIRC to tray on away
  If enabled mIRC will be minimized to tray once you set yourself to away on irc. To set yourself away you can use the rightclick menu in any channel and select SQ-script->away. To unset away you can use the same menu.
  
  
• Silent away
  If checked this prevents the script from sending /me is away (reason) to all channels If unchecked you can select certain channels you want to exclude from messaging.
  
  
• Request Sounds
  If enabled this will make SQ-script to request soundfiles if someone plays a ctcp sound to a channel and you do not have this soundfile yet.
  
  
• Block DCCs while away
  If checked this will prevent others to send you any files while you are set to away. This will disable Soundrequests too and should never be used if the DCC requester is running !
  
  
• Block CTCPs while away
  This will block any CTCP send to you while you are set to away like PING, VERSION, and so on. As DCCs are also CTCP commands i excluded them from this rule, so they will not be affected it this is checked.
  
  
• Enable >!free upload/download< lookup
  If checked it will listen for anyone in the channel saying !free upload or !free download and tell this person if there is a free spot on the server for the specified action (upload/download) if so.
  
  
• Enable Nickkeeper
  If check the script will always try to keep your primary nick you entered in the mIRC options. If someone else is using this nickname it will try to get it back until the nick is freed. This option will also prevent you from chaning your nicks for some other reasons, like fun-nicks or away-nicks. It will always change back to normal.
  
  
• Send away notice if someone mentiones your nick
  If you are set to away and someone mentiones your nick in the channel he will be notified that you are not available right now.
  
  
• Enable Autoaway
  This will set you to away after you have not said anything for the period you have selected.
  
  
• Play this sound if someone openes a query to you
  If someone opens a query to you, you will hear the sound you have chosen. This was intended for busy people like me who do not have mIRC as the active application all the time but still want to be aware of incoming queries.
  
  
• MUSIK WAKEUP
  This can be used to wake you up at a chosen time with music. Note that your computer must be running at this time and you should sleep near it (like i do). The first time you enable it, it will ask you for the players location by selecting the exe(cutable) file. This was tested with winamp and QCD but should work with many others, too. Then you may exclude weekends (saturday, sunday) The choose the music you want to hear. You can choose a radio station (shoutcast server) or a file, this can be a single soundfile (wav,mp3,...) or a complete playlist (m3u,etc). Note that if the radio station is offline at the moment the script wants you to wake up it will stay mute.
  If you are hard to wake up you can choose the musik to become louder after a while until you click anywhere on the screen.
  The bottom button can be used to reset the players location, so if you recheck the the first option you will be asked for the exe file again like the first time.
  When the wakeup time approaches the chosen player will be started playing from the selected source (playlist,radio,file) and the screen will become white with some "instruction" for you. When you click on the screen your desktop will be visible again and the volume will be set to normal again if you chose to let it become louder.
  Try around.
  
  
• Spamblocker
  As you might now there is a shitload of f?ckin lamers out there who just keep on spamming other people and channels. This is intended to block at least the spam send to your query (you might know the feeling of waking up and seeing thousands of queries full of useless spam) so if someone wants to open a query to you and his message matches the wildcards you entered below no query window will be opened.
  Usefull wildcards may be: *http:* , *sex* , etc.
  Note that this will close any queries if you are already talking to someone and he says something matching the wildcard. It will only prevent new queries from opening.
  
  
• Ignore CTCP
  This can be used to block certain CTCP commands either to make your floodprotection more efficient or just to prevent to default response to it, like ctcp ping, time, etc.
  Note that CTCP version cannot be prevented this way, but there is a good dll out there which does this job quite good.
  
  
• Color for user......
  This is merely a cosmetic setting which allows you to see who is doing what on your FTP.
  So if someone is downloading from your server and you have chosen the color for downloading to be 4, his nick will become red in the cannel and the @SQ-Script! window.
  
  

• TAB 4 (FTP server)
  

• Setup FTP server Integration
  This initializes the steps needed to establish the bidirectional connection between the script and the FTP server.
  
  
• Delete old FTP logfiles
  As SQ-Script also takes advantage of available log files from the FTP server it's recommended to delete old files unless you want to keep them for some reason.
  
  
• Start FTP-server when needed
  If enabled the script will start the FTPd when it is not running and the script wants to connect to it.
  
  
• Close FTP-server when closing mIRC
  guess what might happen.....
  
  
• Enable Speedlimit for serving
  if enabled the entered speedlimit will be distributed between all downloaders. This was intended to help adsl users (like me) as when their (mostly very limited) upstream is used up the downstream will suck. So if you select 10000bytes/s as speed limit and are serving for 4 people each of them will not be able to download faster than 2500bytes/s.
  
  
• Display changed speedlimit to users
  If enabled, any changes to the speedlimit (someone else started downloading,etc) will be displayed to the users ftp-client.
  
  
• Restrict Login to IRC-host
  This will force users to use the same host/ip for your server as they use to connect to irc. This will prevent people from giving away accounts to others but may cause problems if you're connecting through some proxy or have a strange LAN configuration. Anyways this option should handly most types of cloaked hosts on IRC (bouncer,etc.)
  
  
• Enable SFV check for uploads
  This handy feature will check and uploaded sfv file containing crc values and verify if the upload is completed or not
  On some slower machines this might make mIRC freezes sometimes (every time a file is uploaded) so you can disable it
  
  
• Netsplit timeout
  This is merely the time someone on your server may leave the channel he activated the trigger before his account will be deleted. Leaving the channel may be caused by:
  Netsplits, broken connection to irc, rejoin, malicious stupidity,...
  If the timeout is exceeded the connection will be closed and the account will be deleted so he will need to rejoin the channel and create another account again.
  
  
• No-user timeout
  If an account is unused for this period of time the account will be deleted.
  Reasons for unused accounts may be: It has just been created, a transfer is finished, the user lost his connection, etc.
  
  
• Max Users Upload/download
  This tells the script how many accounts for the chosen activity may be created.
  
  
• Account Settings
  Here you can make a ruleset for each FTP-info you created. So if you created an FTP-info for All on #channel it will appear in Choose Usergroup. Once selected you can enter the minimum speed and how many times it may be hit.
  This is because the script only makes "snapshots" every minute and the transfer speed can vary a lot. So you should admit to hit the limit at least 3 or 4 times before closing the account.
  To disable this option set minimum speed to 0.
  By selecting on Member of Group you can associate an FTP-info with an FTP-group you created in the FTPd before.
  You can also limit the number of downloads in files or MBs before the account is closed. To disable this limit set it to 0.
  Max users is a sub-limit to the maximum users option above, meaning that the limit above is the real limit even if this one is set higher. As the top-limit is an over-all rule for all downloaders you could use it this way:
  Maximum downloaders 3
  max users on channel #1 is 0
  max users on channel #2 is 1
  so from channel #1 there may login people up to a limit of 3.
  from channel #2 there can be only 1 at a time, but only if there are not 3 from channel #1. So possible combinations would be
  (#1 - #2)
  3 - 0
  2 - 1
  1 - 1
  0 - 1
  So this is mainly used to set priorites to channels.
  Note that you can only edit download accounts this way, upload accounts are all handled with one rule selectable in Choose Usergroup. All settings will be saved in the Header of FTP-info so you should not edit it there.
  
  
• Server settings for SQ-script
  You cannot change anything here (now). It's used to check the correct settings and to fill up the space.
  
  
• SQ-script banlist
  If someone was banned from your server manually he will appear in this list and will not be able to create any other account again until removed.
  Note that the banlist can only contain 8 bans, so any addition will drop out the oldest ban set (cycled). To remove someone manually, doubleclick on him.
  
  
• <Channel Ad>
  Here you can enter a line to advertize your server in channel(s). You can and should use Variables here (about variables see tab 2).
  Try not to make it too large, it may excess flood you.
  As always you should make a constant use of the preview button.
  
  

• TAB 5 (Messenger/DCC request)
  

• Enable Notifier
  This is a (IMHO) very useful option which tells you if anyone mentioned your nick in any channel you are and opens a small window at the top left of your screen with the info who mentioned you where. If you click on this window the specified channel is opened, else the window will disappear after 7 secs.
  It will stop working while you are set to away.
  
  
• Enable logging
  This will log any line where your nick appears to the @SQ-Script!.
  
  
• Show @SQ-script! window as a separate window in taskbar
  Try out and see
  
  
• Play this sound, if someone mentiones your nick
  This will only trigger if it is not the active channel. Should be used with the notifier.
  
  
• DCC requests
  Better read the step-by-step explanations above.
  
  

• TAB 6 (Eggdrop)
  

• <Eggdrop tools>
  This options were made for channel OPERATORS. So if you are not a channel OPERATOR (or owner) and are using some EGGDROP bots or do not even know what I am talking about this is definately NOT OF ANY INTEREST FOR YOU.
  
  If you know what all this means and are a channel operator or owner you should know what these options mean. I only recommend you to be careful with any revenge options.
  The script does various checkups BEFORE connecting to a bot and sending your password, like ip lookups, check if OP, etc.
  Your password is saved encrypted in the script settings with a system specific key drawn out of the mirc executable. So if for any reason (update,reinstall,etc) your mirc.exe changes you will need to reenter the bots. The key is not related to the version of mIRC.
  On any doubts or questions feel free to ask me.
  
  

This script has an inbuilt SFV-checker. So whenever someone uploads a .sfv file containing CRC hashes the script checks for the files hashed and tells you wether the upload was successfull or not and rechecks when any other file has been uploaded.

When someone else is using SQ-script (3.1.2+) and is running an ad for his FTP server the script will memorize the the nick for two hours (if the ad doesn't show up meanwhile he is deleted from memory). Within these two hours you can rightclick on that nick and select
"Connect to FTP".
Note: The Script will only recognize someone for using the same script if the ad ends in »SQ-Script« (as it normaly does). So if you use your own ad or had the need to remove it from the script others will not recognize you for using SQ-Script.
Anyway there's no need to be ashamed of =)

A Small menu will appear that lets you choose wether you want to upload or download and your own ip. When everything is correct click on "Create" and a request will be sent to the nick for chosen selections.
This is an alternative to the normal trigger and ^accountomat as it works much faster.
If you get no answer from a nick this may be because of:

• He hasn't got the latest version of the script
• He turned of the FTP meanwhile
• He got some kind of floodprotection running
• You are ignored

So if you get no answer the first time there is NO NEED for a 2nd try after a few seconds!

When rightclicking in a channel you can select the option SQ-Script->Search to search for a specific file on the server of this channel.
A small window will popup and ask you for the string you want to search for and if you want to search via public @find or ctcp to a search hub. If you select to search via ctcp you will need to select the search HUBs nick.
This window can also be customized with a mask, read on.....

If you want to customize the script for your special needs or you want to distribute this script in your channel but don't like some options/settings/features there is a way to create a mask for this script to make it look and work the way you want it to.
e.g. You want to distribute this script in your channel but you do not want anyone to use the @find feature as it is not allowed in your channel. You tell me what you want the script to look like an i will email you a file called mask.conf that has to reside in the scripts directory to take effect.
So when you give away a copy of the script just make sure you included the mask.conf into the package so everyone has the same menu/restrictions.
This can also be used to change the default settings and to prevent to change them after loading the script.
So just tell me about your needs. EVERYTHING CAN BE CHANGED and it is no big deal to do it.
Write me an email with a detailed description of your changes and I'll send you the mask.

How do I update SQ-script ?

The newer script version provide the function of selfupdate through this homepage, so you only need to rightclick in the @SQ-Script! window and select the right item. In case the auto-update does not work you can also try the following:


• get the new script from my homepage
• unload the old script with the button in misc tab but don't delete the settings
• unpack the new files overwriting the old ones
• load the script as you did the first time

Why does my eggdrop tell me wrong password though it worked all the time

Probaply you updated your mirc or changed its directory. The encryption for the paswords depends on the mirc32.exe and changes if any changes on this file were made. That´s why noone else should be able to find out your real password even if he sees the encrypted one.

Why does my nickname change back after some time after I changed it ?

Probably you activated the nickkeeper feature. This feature tries to always keep your primary nick, even if you changed it manually.

Is there another way to access the variables of SQ-script ?

Yes, there is. When making your own script and have SQ-script loaded you can use the $sq.setvariables(TEXT) variable, where TEXT can be anything containing SQ-script variables:

eg.: //echo -a $sq.SetVariables(My uptime record:^recorduptime)

Note: use 2 colons "::" to represent a coma "," especially for background colors,etc.